home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / word / wp2latex.zip / WP2LATEX.DOC < prev    next >
Text File  |  1990-11-18  |  6KB  |  166 lines
  1.  
  2. Dear Wordperfect and/or LaTeX user,
  3.  
  4. In january the WP2LaTeX program was released from Eindhoven
  5. University of Technology. Unfortunately the original 
  6. documentation was in Dutch. There is no english version available. 
  7. However, this shouldn't be to big a problem. In short, this is
  8. summary of what the original documentation is about. In this translation
  9. I sometimes refer to some pictures form the original documentation, so
  10. please use this translation as well as the original documentation.
  11.  
  12. 1. Introduction
  13.    The program tries to make a projection from the world of
  14.    wordprocessing (Wordperfect) to the world of typesetting (LaTeX).
  15.    This implicates that certain rules should be taken into 
  16.    consideration when making a document using Wordperfect.
  17.  
  18. 2. What is being converted and what is not
  19.  
  20.    converted :
  21.    - hard return (hard line break)
  22.    - hard page break
  23.    - typefaces:
  24.      - extra big
  25.      - ...
  26.      - very small
  27.      - superscript
  28.      - subscript
  29.      - italics
  30.      - small caps
  31.      - boldface
  32.      - underscore
  33.      - double underscore
  34.    - some extended characters
  35.    - overstrike
  36.    - tabs (left, right, center)
  37.    - jump right (Alt F6)
  38.    - parallel columns (fixed position decimal colon)
  39.    - indenting (left, left and right)
  40.    - footnotes
  41.    - headers en footers
  42.    - position pagenumber
  43.    - justification on/off
  44.  
  45.   Not being converted:
  46.   - margin settings
  47.   - newspaper-style columns
  48.   - line spacing
  49.   - top- and bottom margins
  50.   - index
  51.   - references
  52.   - end-notes
  53.   - table of contents
  54.   - grafical images
  55.  
  56. 3 Guidelines
  57.  
  58. 3.1 Tabbing
  59.     Never allow a line containing [Tab]'s to be broken by a soft return
  60.     ( [ZRt] in the Dutch version of Wordperfect, [SRt] in the English
  61.     one I assume).
  62.  
  63.     If you use accents in a tabbing-environment, be aware of the fact
  64.     that wp2latex doesn't convert these accents correctly. Normally accents
  65.     are made by \', \` and \=, but in a tabbing-environment these
  66.     commands have another definition. They should be replaced by
  67.     \a`, \a` en \a= respectively. The maximum number of tabs LaTeX
  68.     can handle is 14. Wordperfect can handle 40 tabs on one line.
  69.     So don't use more than 14 tabs.
  70.  
  71. 3.2 Indenting
  72.     There are 3 options that can be converted:
  73.  
  74.     [Indent]*   One paragraph that may [SRt]
  75.                 be spread over several lines [SRt]
  76.                 and must be ended by a hard return. [HRt]
  77.  
  78.     label [Indent]*  A label (some text) may be put [SRt]
  79.                      in front of a paragraph. [HRt]
  80.  
  81.     [Indent]* label [Indent]* The label itself may be indented [SRt]
  82.                               so that we have 2 indentation [SRt]
  83.                               levels. [HRt]
  84.  
  85.     [Indent]*  means one or more than one [Indent] (F4)
  86.  
  87.     By [SRt] I mean a soft line break (soft return). I am not shure
  88.     that I'm using the right translations because I don't use an
  89.     English version of Wordperfect. 
  90.  
  91. 3.3 Combinations of tabs en indenting.
  92.     You should not mix tabbing and indentation when you plan on using
  93.     this conversion program. This is because these 2 things are
  94.     completely different in the world of LaTeX, although this 
  95.     distinction is hard to make for a Wordperfect user.
  96.  
  97. 3.4 Footnotes
  98.     Within a footnote only hard returns and typeface-changes (section 2)
  99.     will be converted. A footnote-number may only contain digits.
  100.  
  101.     When using footnotes within a line containing tabs, the footnote
  102.     will not be put at the bottom of the page. This is a LaTeX-bug.
  103.  
  104. 3.5 Headers and footers
  105.     Only typefaces will be converted. The header/footer may be split
  106.     into 3 parts. A left part, a centered part and a right part 
  107.     (see figure 1). Use Shft F6 for centering and Alt F6 for the 
  108.     right part.
  109.  
  110. 3.6 Page number posotions
  111.     The positions shown in figure 2 will be converted.
  112.  
  113. 3.7 Wordperfect defaults
  114.     The left margin of the converted document will be 1 inch. Therefor
  115.     the program assumes that the Wordperfect left-margin is also 1 inch
  116.     and not being changed in the document. The default tab-settings will
  117.     be set on every inch.
  118.     It can be tricky not to follow the above guideline because in LaTeX
  119.     the tab-setting is relative to the left margin, whereas in
  120.     Wordperfect these two are independent (see figure 3).
  121.  
  122. 3.8 Spaces
  123.     Normally LaTeX ignores more than one space, and treats them like there
  124.     was only one space. Because many Wordperfect users use the spacebar
  125.     for lay-outing, obsolete spaces will be converted into tildes (~) and
  126.     therefor not be ignored.
  127.  
  128. 4 The program
  129.   I think this section is clear without further translation. The first line
  130.   of the converted document will always be:
  131.  
  132.   \documentstyle[11pt,wp2latex]{report}
  133.  
  134.   where wp2latex.sty is a style-file that should be used when LaTeX-ing
  135.   a converted document. It contains some macros like \nwln.
  136.  
  137. 5 Finally
  138.   A 100 percent correct conversion can not be guaranteed. In most cases
  139.   the converted document will need some modification in order to
  140.   get the best results.
  141.  
  142.  
  143. Because the sources are included (Turbo Pascal 5.0) you should be able to
  144. modify the program when you want to convert Wordperfect 5.1 documents, 
  145. provided you know what file formats are being used by Wordperfect.
  146. The file formats we used for our program, we found in the WordPerfect
  147. 5.0 Developer's Toolkit. I would assume that there exists such a toolkit
  148. for version 5.1 of Wordperfect. Because 5.0 documents are compatible with
  149. 5.1 documents (are they ?) it shouldn't be such a big deal. Of course
  150. you shouldn't try to convert the new 5.1 formula's because they are
  151. treated as graphical images as I understood (at this moment I don't
  152. use version 5.1).
  153.  
  154. I hope this short translation will help you using the wp2latex-program.
  155. If you have any further questions, don't hesitate to ask them.
  156.  
  157.  
  158. Sincerely,
  159.  
  160.    Ron Helwig
  161.    Eindhoven University of Technology
  162.    Department of Mathematics and Computer Science
  163.    The Netherlands
  164.  
  165.    e-mail: rcronh@urc.tue.nl
  166.